home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 22 / PC Actual CD 22.iso / linux / xfree86 / DOC / README.SOLX86 < prev    next >
Encoding:
Text File  |  1998-01-07  |  10.1 KB  |  463 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.              Information for Solaris for x86 Users
  11.  
  12.                  David Holland
  13.  
  14.                   16 May 1997
  15.  
  16.  
  17.  
  18. 1.  What is XFree86 3.3
  19.  
  20. XFree86 3.3 is a port of X11R6.3 that supports several versions of Intel-based
  21. Unix.  It is derived from X386 1.2 which was the X server distributed with
  22. X11R5.    This release consists of many new features and performance improvements
  23. as well as many bug fixes.  The release is available as source patches against
  24. the X Consortium code, as well as binary distributions for many architectures.
  25.  
  26. The sources for XFree86 are available by anonymous ftp from:
  27.  
  28.      ftp://ftp.XFree86.org/pub/XFree86/current
  29.  
  30.  
  31. Solaris binaries for XFree86 are available for anonymous ftp from:
  32.  
  33.      ftp://ftp.XFree86.org/pub/XFree86/current/binaries/Solaris
  34.  
  35.  
  36. 2.  Solaris for x86, versions on which XFree86 3.3 has been tested
  37.  
  38. XFree86 3.3 has been actively tested on:
  39.  
  40.    o Solaris 2.4 for x86 FCS
  41.  
  42.    o Solaris 2.5.1 for x86
  43.  
  44. And is expected to run under:
  45.  
  46.    o Solaris 2.4 EA2 for x86
  47.  
  48.    o Solaris 2.5 for x86
  49.  
  50.  
  51. 3.  The VT-switching sub-system in Solaris x86
  52.  
  53. The virtual terminal sub-system is a undocumented, and unsupported feature of
  54. Solaris x86. Therefore if you use Virtual Terminals, you do so at YOUR OWN
  55. RISK.
  56.  
  57. The virtual terminals of Solaris work basically the same way as most other
  58. Intel based SVR4 VT sub-systems.  However, there are a number of limitations
  59. documented below.
  60.  
  61. First, if you are running a Solaris 2.4 x86 system, and you want VT's, you will
  62.  
  63.  
  64. Information for Solaris for x86 Users
  65.  
  66.  
  67.  
  68.  
  69.  
  70. Information for Solaris for x86 Users
  71.  
  72.  
  73.  
  74. have to create the necessary devices first, so become root.
  75.  
  76. First verify the chanmux device driver's major number is 100:
  77.  
  78.       # grep -i chanmux /etc/name_to_major
  79.       chanmux 100
  80.       #
  81.  
  82.  
  83. If the number after 'chanmux' is anything but 100, I would suggest you immedi-
  84. ately abort your attempt to create virtual terminals, and learn to live without
  85. them.
  86.  
  87.  
  88.  
  89. However, if it is 100, then as root type the following commands to create the
  90. maximum allowable number of virtual terminals.
  91.  
  92.       # cd /dev
  93.       # mknod vt01 c 100 1
  94.       # mknod vt02 c 100 2
  95.       # mknod vt03 c 100 3
  96.       # mknod vt04 c 100 4
  97.       # mknod vt05 c 100 5
  98.       # mknod vt06 c 100 6
  99.       # mknod vt07 c 100 7
  100.  
  101.  
  102. There is no need for a reconfiguration boot.
  103.  
  104. Secondly, for both 2.1, and 2.4 x86 systems, add a few lines to the inittab to
  105. enable logins on them.
  106.  
  107. (Note, do NOT make a mistake here, you could lock yourself out of the system)
  108.  
  109.      --------------------->Snip Snip<-----------------------------------------------
  110.      v1:234:respawn:/usr/lib/saf/ttymon -g -h -p "`uname -n` VT01 login: " -T AT386 -d /dev/vt01 -l console
  111.      v2:234:respawn:/usr/lib/saf/ttymon -g -h -p "`uname -n` VT02 login: " -T AT386 -d /dev/vt02 -l console
  112.      v3:234:respawn:/usr/lib/saf/ttymon -g -h -p "`uname -n` VT03 login: " -T AT386 -d /dev/vt03 -l console
  113.      v4:234:respawn:/usr/lib/saf/ttymon -g -h -p "`uname -n` VT04 login: " -T AT386 -d /dev/vt04 -l console
  114.      ---------------------->End Here<-----------------------------------------------
  115.  
  116.  
  117. These four lines enable four VT's on Alt-SysReq-F1 through Alt-SysReq-F4.
  118.  
  119. Then execute the command 'init q' to immediately enable the virtual terminals.
  120.  
  121. The keys used for VT switching are as follows:
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. Information for Solaris for x86 Users
  137.  
  138.  
  139.  
  140.      Alt-SysReq-F1 through Alt-SysReq-F7 enable VT screens 1-7 respec-
  141.      tively (if the VT is active).
  142.  
  143.      Alt-SysReq-n enables the next active VT screen.
  144.  
  145.      Alt-SysReq-p enables the previous active VT screen.
  146.  
  147.      Alt-SysReq-h returns to the console.
  148.  
  149.  
  150. If you are using virtual terminals, you must leave at least one free for use by
  151. the Xserver.
  152.  
  153. Limitations of the virtual terminal sub-system under Solaris x86:
  154.  
  155. There are only a total of 8 available VT's (7 normal VT's + 1 console) not the
  156. usual 15. If you have all 8 allocated, and you attempt to allocate a additional
  157. VT you will panic the system. (This bug is worked around in the Solaris XFree86
  158. Xserver.)
  159.  
  160. From a programming stand point, they work pretty much as documented in the AT&T
  161. Unix System V/386 Release 4 Integrated Software Development Guide, however a
  162. number of ioctl() calls are broken.
  163.  
  164.  
  165. 4.  Notes for building XFree86 on Solaris x86
  166.  
  167.   1.  The majority of all modifications you will need to make are now in
  168.       ~xc/config/cf/xf86site.def.
  169.  
  170.  
  171.   2.  Both Gcc, and ProWorks are supported by XFree86. Gcc-2.5.8 or gcc-2.7.2
  172.       are suggested, Gcc-2.6.0 is known not to work.  You also need to set Has-
  173.       Gcc2 correctly in ~xc/config/cf/xf86site.def.
  174.  
  175.       You should also make certain your version of GCC predefines `sun'.  2.4.5
  176.       is known NOT to by default.  If needed edit /usr/local/lib/gcc-
  177.       lib/*/*/specs, and modify the *predefines: line.
  178.  
  179.       Note: A Threaded Xlib compiled with GCC has subtle problems.  It'll work
  180.       98% of the time, however clients will occasionally exhibit strange hangs.
  181.       Most notably image viewers such as xv-3.10 exhibit this problem.
  182.  
  183.       It is recommended that you set ThreadedX in ~xc/config/cf/sun.cf to NO,
  184.       if you are using GCC.  ProWorks does not have this problem.
  185.  
  186.   3.   To build XFree86 with gcc you need gcc and (optionally) c++filt from
  187.       GNU binutils. Don't install gas or ld from GNU binutils, use the one pro-
  188.       vided by Sun.
  189.  
  190.       With XFree86 3.3, you will need to setup a /opt/SUNWspro/bin directory
  191.       containing symbolic links named cc, CC, and c++filt pointing respectively
  192.       to the actual gcc, g++ and c++filt commands.
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. Information for Solaris for x86 Users
  203.  
  204.  
  205.  
  206.   4.  If you don't have c++filt or if you have troubles in making World with
  207.       c++filt, you need to set UseExportLists to NO in ~xc/config/cf/host.def.
  208.  
  209.  
  210.  
  211.   5.  If you are using ProWorks to compile the XFree86 distribution, you need
  212.       to modify your PATH appropriately so the ProWorks tools are available.
  213.       Normally, they should be in /opt/SUNWspro/bin
  214.  
  215.   6.  You MUST put /usr/ccs/bin at the front of your PATH. There are known
  216.       problems with some GNU replacements for the utilities found there. So the
  217.       /usr/ccs/bin versions of these programs must be found before any other
  218.       possible GNU versions. (Most notably GNU 'ar' does not work during the
  219.       build).
  220.  
  221.   7.  If you wish to use the "memory aperture" feature of the S3, and Mach32
  222.       servers, you need to compile, and install the Solaris x86 aperture driver
  223.       for memory mapped I/O support.  This driver is REQUIRED for the I128,
  224.       P9000 and Mach 64 servers.
  225.  
  226.       You  need to set HasSolx86apertureDrv to YES in ~xc/con-
  227.       fig/cf/xf86site.def.
  228.  
  229.        to enable the aperture driver.
  230.  
  231.       Under Solaris 2.5 and 2.5.1, there's a system driver (/dev/xsvc that pro-
  232.       vides this functionality. It will be detected automatically by the
  233.       server, so you don't need to install the driver.
  234.  
  235.       For Solaris 2.1 and 2.4, the source for this driver is included in
  236.       ~xc/programs/Xserver/hw/xfree86/etc/apSolx86.shar.  Building, and
  237.       installing the driver is relatively straight forward. Please read its
  238.       accompanying README file.
  239.  
  240.  
  241. 5.  Notes for running XFree86 on Solaris x86
  242.  
  243.   1.  If you have not made the Virtual Terminal devices, you will need to spec-
  244.       ify the terminal device to run the Xserver on.  The correct device is
  245.       vt00 so your xinit command would look like so:
  246.  
  247.              xinit -- vt00
  248.  
  249.  
  250.       If you have made the virtual terminal devices you do not need to specify
  251.       the VT to run the Xserver on.
  252.  
  253.       To be able to run XF86Setup, you must at least create /dev/vt01. Other-
  254.       wise XF86Setup won't start.
  255.  
  256.   2.  For Solaris you will probably want to set your LD_LIBRARY_PATH to
  257.       /usr/X11R6/lib:/usr/openwin/lib:/usr/dt/lib.  Including /usr/X11R6/lib in
  258.       your LD_LIBRARY_PATH is probably not necessary, however it doesn't hurt.
  259.       :)
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. Information for Solaris for x86 Users
  269.  
  270.  
  271.  
  272.       Including /usr/openwin/lib in the LD_LIBRARY_PATH is recommended because
  273.       some Sun supplied binaries were not compiled with LD_RUN_PATH set prop-
  274.       erly at compile time.
  275.  
  276.       Motif and CDE applications may require /usr/dt/lib in your
  277.       LD_LIBRARY_PATH too.
  278.  
  279.   3.  Xqueue is NOT supported under Solaris.  The includes necessary for Xqueue
  280.       are available, however the driver does not seem to be in the kernel. (Go
  281.       figure)
  282.  
  283.   4.  If you want to use xdm with Solaris, extract the files from the shar file
  284.       in /usr/X11R6/lib/X11/etc/XdmConf.svr4 into a temporary directory. The
  285.       README file tells where the individual files need to be installed.  Be
  286.       sure to read through each file and make any site-specific changes that
  287.       you need.
  288.  
  289.  
  290. 6.  Known bugs, and work arounds with Solaris x86
  291.  
  292.   1.  The Solaris 2.1 for x86 OpenWindows filemgr does not work against a X11R5
  293.       Xserver, it probably will also not work against a X11R6 Xserver.
  294.       Attempting to 'Drag and Drop' a file causes the filemgr to abort with a
  295.       'X error'
  296.  
  297.       Solaris 2.4 does not have this problem.
  298.  
  299.       There is no known work around.
  300.  
  301.  
  302. 7.  Bug Notification
  303.  
  304. Bug reports need to be sent to XFree86@XFree86.org, or posted to the comp.win-
  305. dows.x.i386unix newsgroup.  Questions or comments about the Solaris support, or
  306. the Solaris distribution need to be made to davidh@use.com, or danson@lgc.com.
  307.  
  308.      Generated from XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/SOLX86.sgml,v 3.12.2.4 1997/05/24 08:36:08 dawes Exp $
  309.  
  310.  
  311.  
  312.  
  313.  
  314.      $XConsortium: SOLX86.sgml /main/7 1996/10/28 05:43:28 kaleb $
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. Information for Solaris for x86 Users
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.                    CONTENTS
  405.  
  406.  
  407.  
  408. 1. What is XFree86 3.3 ...................................................... 1
  409.  
  410. 2. Solaris for x86, versions on which XFree86 3.3 has been tested ........... 1
  411.  
  412. 3. The VT-switching sub-system in Solaris x86 ............................... 1
  413.  
  414. 4. Notes for building XFree86 on Solaris x86 ................................ 3
  415.  
  416. 5. Notes for running XFree86 on Solaris x86 ................................. 4
  417.  
  418. 6. Known bugs, and work arounds with Solaris x86 ............................ 5
  419.  
  420. 7. Bug Notification ......................................................... 5
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.                        i
  461.  
  462.  
  463.